revXMLCreateTree
Type
function
Summary
Creates an XML tree structure from XML text data.
Syntax
revXMLCreateTree(<XMLText>, <dontParseBadData>, <createTree>, <sendMessages>)
Description
Use the revXMLCreateTree function to make XML text into an XML tree that you can use with other XML library commands and functions.
If the dontparseBadData is false, the revXMLCreateTree function tries to parse XML data even if it is not well-formed. Otherwise, the function stops executing as soon as it encounters data that is not well-formed XML.
If the createTree is true, the function creates a tree structure in memory. Otherwise, the function simply parses the XML data without creating an XML tree.
If the sendMessages is true, the revXMLStartTree, revStartXMLNode, revStartXMLData, revEndXMLNode, and revXMLEndTree messages are sent while the XML data is being parsed. Otherwise, these messages are not sent.
If the revXMLCreateTree function encounters an error, it returns an error message starting with "xmlerr".
The revXMLCreateTree function is part of the XML library. To ensure that the function works in a standalone application, you must include this custom library when you create your standalone. In the Inclusions pane of the Standalone Application Settings window, make sure the "XML" checkbox is checked.
Parameters
| Name | Type | Description |
|---|---|---|
XMLText | string | |
dontparseBadData | bool | |
createTree | bool | |
sendMessages | bool |
Examples
revXMLCreateTree(field "XML Data",true,true,false)
put revXMLCreateTree(theData,false,true,false) into theError
Related
keyword: integer
library: XML library
message: revStartXMLData, revStartXMLNode, revEndXMLNode, revXMLStartTree, revXMLEndTree
command: revXMLDeleteAllTrees, revXMLMoveNode, revXMLAppend
control structure: function
function: revXMLValidateDTD, revXMLTrees
glossary: LiveCode custom library, return, XML tree, Standalone Application Settings, message, standalone application, XML, function, command
Compatibility and Support
Introduced
LiveCode 2.0
OS
mac
windows
linux
ios
android
Platforms
desktop
server
mobile